第五章. Cron 触发器及相关内容 (第三部分)

四. 为 CronTrigger 使用起迄日期

Cron 表达式是用来决定一个 Trigger 被触发执行一个 Job 的日期和次数。当你创建一个 CronTrigger 实例，假如没为它指定一个开始时间，这个 Trigger 当然就会假定是在依赖于 Cron 表达式尽早的被触发。例如，如果你用这个表达式

0 * 14-20 * * ?

这个 Trigger 会在每天的从下午 2 点到下午的 7:59 间的每分钟触发一次。一旦你运行了这个表达式的 CronTrigger，假如当前是下午 2 点后(不能超过 7:59 PM--译者注)，它将会立即触发。它会在每天无限期的被触发。

另一方面，倘若你希望这个计划直到下一天才开始，并且只执行两天，你就可以用 CronTrigger 的 setStartTime() 和 setEndTime() 方法来形成一个 "定时箱" 来触发。代码 5.2 描述了限定 CronTrigger 仅触发两天的例子。

代码 5.2. 你可以对 CronTrigger 用 startTime 和 endTime

public class Listing_5_2 {
     static Log logger = LogFactory.getLog(Listing_5_2.class);

public static void main(String[] args) {
          Listing_5_2 example = new Listing_5_2();
          example.runScheduler();
     }

public void runScheduler() {
          Scheduler scheduler = null;

try {

// Create a default instance of the Scheduler
              scheduler = StdSchedulerFactory.getDefaultScheduler();
              scheduler.start();
              logger.info("Scheduler was started at " + new Date());

// Create the JobDetail
              JobDetail jobDetail = new JobDetail("PrintInfoJob",
                        Scheduler.DEFAULT_GROUP,
                                    PrintInfoJob.class);

// Create a CronTrigger
              try {
                   // cron that fires every min from 2  8pm
                   CronTrigger trigger =
                                    new CronTrigger("MyTrigger", null,
                                                   "0 * 14-20 * * ?");

Calendar cal = Calendar.getInstance();
                   // Set the date to 1 day from now
                   cal.add(Calendar.DATE, 1);
                   trigger.setStartTime(cal.getTime());

// Move ahead 2 days to set the end time
                   cal.add(Calendar.DATE, 2);
                   trigger.setEndTime(cal.getTime());

scheduler.scheduleJob(jobDetail, trigger);
              } catch (ParseException ex) {
                   logger.error("Couldn't parse cron expr", ex);
              }

} catch (SchedulerException ex) {
              logger.error(ex);
         }
    }
}

代码 5.2 中的例子使用了 java.util.Calendar 来为 Trigger 选择一个开始和结束时间周期。在上面例子中，Trigger 将会在 Scheduler 启动后的下一天开始触发，并只在开始触发后的两天内有效。

使用 CronTrigger 的 startTime 和 endTime 属性的效果有点像 SimpleTrigger。

五. 为 CronTrigger 使用 TriggerUtils

在第四章，"安排 Job" 中介绍了 org.quartz 包中的 TriggerUtils 类，它简化了两种类型的 Trigger 的创建。只要可能的话，你应该尝试用 TriggerUtils 类的方法来创建你的 Trigger。

例如，假如你需要在每天的下午 5:30 执行一个 Job，你可以用下面的代码：

或者你能用上 TriggerUtils，如下：

TriggerUtils 使得我们更简单方便的使用 Trigger，而又未放弃太多的灵活性。

六. 在 JobInitializationPlugin 中使用 CronTrigger

尽管我们要到第八章，"使用 Quartz 插件" 才会讲到插件，但还是值得提前展现一下 CronTrigger 如何应用于 quartz_jobs.xml 文件中来指定 Job 信息的。JobInitialzationPlugin 可用来从 XML 文件中加载 Job 的信息。

正如 SimpleTrigger 一样，你可在 XML 文件中指定 CronTrigger 的表达式，并且 Quartz 的 Scheduler 将会利用这一信息来安排你的 Job。这对于你想在你的程序代码之外声明你的 Job 信息时特别方便。代码 5.3 显示了 quartz_jobs.xml 文件内容，它被 JobInitializationPlugin 用来加作 Job 信息。

代码 5.3. CronTrigger 可在 XML 文件中指定，并由 JobInitializationPlugin 加载

代码 5.3 中的 Cron 表达式与代码 5.1 中。当 Quartz 加载这个 XML 后，就会安排 PrintInfoJob (也已在 XML 中列出) 在从星期一到星期五的早上 7:30 执行。关于 JobInitializationPlugin 更多的说明见第八章。